home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Development / General / Menu Events 1.1.2 / Menu Events Help / Menu Events Help.rsrc / STR#_1029.txt < prev    next >
Text File  |  1994-04-20  |  13KB  |  735 lines
  1. 
  2.  
  3. 
  4.  
  5. noSuchMenuItemErr      -21001
  6.  
  7. noSuchMenuErr          -21000
  8.  
  9. menuItemDisabledErr    -21002
  10.  
  11. menuEventPendingErr    -21003
  12.  
  13. kMEEventClass          'M√¶nu'
  14.  
  15. keyShiftKeyPressed     'shik'
  16.  
  17. keyOptionKeyPressed    'optk'
  18.  
  19. keyMenuTitle           'mnti'
  20.  
  21. keyMenuMDEFID          'mndf'
  22.  
  23. keyMenuItemText        'mite'
  24.  
  25. keyMenuItemStyle       'mist'
  26.  
  27. keyMenuItemMark        'mima'
  28.  
  29. keyMenuItemID          'miid'
  30.  
  31. keyMenuItemIcon        'miic'
  32.  
  33. keyMenuItemEnabled     'mien'
  34.  
  35. keyMenuItemCmd         'micm'
  36.  
  37. keyMenuID              'mnid'
  38.  
  39. keyMenuEventsTattoo    'M√¶nu'
  40.  
  41. keyMenuEnabled         'mnen'
  42.  
  43. keyControlKeyPressed   'conk'
  44.  
  45. keyCommandKeyPressed   'comk'
  46.  
  47. kAEMESelectMenuItem    'semi'
  48.  
  49. kAEMEQueryMenuList     'qmn#'
  50.  
  51. kAEMEQueryMenu         'qmn '
  52.  
  53. 
  54.  
  55. 
  56.  
  57. Constant               Value
  58.  
  59. 
  60.  
  61. xConstants defined in the Menu Events suite
  62.  
  63. 
  64.  
  65. 
  66.  
  67. 
  68.  
  69. 
  70.  
  71.                                           on this application
  72.  
  73.                                           is already pending
  74.  
  75.                                   -21003  Another Menu event
  76.  
  77.                   menuEventPendingErr
  78.  
  79. 
  80.  
  81. 
  82.  
  83.                                           disabled
  84.  
  85.                                   -21002  The item is
  86.  
  87.                   menuItemDisabledErr
  88.  
  89. 
  90.  
  91. 
  92.  
  93.                                           such item
  94.  
  95.                                   -21001  The menu has no
  96.  
  97.                   noSuchMenuItemErr
  98.  
  99. 
  100.  
  101. 
  102.  
  103.                                           no such menu
  104.  
  105.                   noSuchMenuErr   -21000  The application has
  106.  
  107. 
  108.  
  109. 
  110.  
  111.                                           with remote processes
  112.  
  113.                                           extension is locked)
  114.  
  115.                                           or (if Menu Events
  116.  
  117.                                           with other processes
  118.  
  119.                                           refusing to interact
  120.  
  121.                                   -1713   The application is
  122.  
  123.                   errAENoUserInteraction
  124.  
  125. 
  126.  
  127. 
  128.  
  129.                                           no menu bar
  130.  
  131.                   mBarNFnd        -126    The application has
  132.  
  133. Result Codes
  134.  
  135. 
  136.  
  137. 
  138.  
  139. 
  140.  
  141.                   Required or Optional?  Required
  142.  
  143.                   Descriptor Type:  typeNull
  144.  
  145.                                 the event
  146.  
  147.                                 that Menu Events handled
  148.  
  149.                   Description:  A null parameter to verify
  150.  
  151. keyMenuEventsTattoo
  152.  
  153. 
  154.  
  155. 
  156.  
  157. Reply Parameters
  158.  
  159. 
  160.  
  161. 
  162.  
  163.                   Default Value:  false
  164.  
  165.                   Required or Optional?  Optional
  166.  
  167.                   Descriptor Type:  typeBoolean
  168.  
  169.                                 simulated menu selection
  170.  
  171.                                 pressed at the time of the
  172.  
  173.                   Description:  Whether the Command key is
  174.  
  175. keyCommandKeyPressed
  176.  
  177. 
  178.  
  179. 
  180.  
  181.                   Default Value:  false
  182.  
  183.                   Required or Optional?  Optional
  184.  
  185.                   Descriptor Type:  typeBoolean
  186.  
  187.                                 simulated menu selection
  188.  
  189.                                 pressed at the time of the
  190.  
  191.                   Description:  Whether the Option key is
  192.  
  193. keyOptionKeyPressed
  194.  
  195. 
  196.  
  197. 
  198.  
  199.                   Default Value:  false
  200.  
  201.                   Required or Optional?  Optional
  202.  
  203.                   Descriptor Type:  typeBoolean
  204.  
  205.                                 simulated menu selection
  206.  
  207.                                 pressed at the time of the
  208.  
  209.                   Description:  Whether the Control key is
  210.  
  211. keyControlKeyPressed
  212.  
  213. 
  214.  
  215. 
  216.  
  217.                   Default Value:  false
  218.  
  219.                   Required or Optional?  Optional
  220.  
  221.                   Descriptor Type:  typeBoolean
  222.  
  223.                                 simulated menu selection
  224.  
  225.                                 pressed at the time of the
  226.  
  227.                   Description:  Whether the Shift key is
  228.  
  229. keyShiftKeyPressed
  230.  
  231. 
  232.  
  233. 
  234.  
  235.                   Required or Optional?  Required
  236.  
  237.                   Descriptor Type:  typeShortInteger
  238.  
  239.                                 from 1 at the top of the menu
  240.  
  241.                   Description:  The ID of the item, numbered
  242.  
  243. keyMenuItemID
  244.  
  245. 
  246.  
  247. 
  248.  
  249.                   Required or Optional?  Required
  250.  
  251.                   Descriptor Type:  typeShortInteger
  252.  
  253.                                 List Apple event
  254.  
  255.                                 returned by a Query Menu
  256.  
  257.                   Description:  The ID of the menu, as
  258.  
  259. keyMenuID
  260.  
  261. 
  262.  
  263. 
  264.  
  265. Parameters
  266.  
  267. 
  268.  
  269. Event ID          kAEMESelectMenuItem
  270.  
  271. 
  272.  
  273. Event Class       kMEEventClass
  274.  
  275. 
  276.  
  277. refuses to interact with remote processes (kAEInteractWithLocal mode).
  278.  
  279. another machine and the Menu Events extension has been locked, if it
  280.  
  281. other processes (kAEInteractWithSelf mode), or, if the application is on
  282.  
  283. menu item.  Interaction will fail if the application refuses to interact with
  284.  
  285. in the usual way, the result is as if the user had actually selected that
  286.  
  287. event is correctly handled, and the application reacts to the mouse events
  288.  
  289. of the given menu item, with modifier key states as specified.  If the Menu
  290.  
  291. application to the front, then posts mouse events to simulate the selection
  292.  
  293. A Select Menu Item event requests user interaction to bring the
  294.  
  295. 
  296.  
  297. xSelect Menu Item - perform a menu command
  298.  
  299. 
  300.  
  301. 
  302.  
  303. 
  304.  
  305. 
  306.  
  307.                                           no such menu
  308.  
  309.                   noSuchMenuErr   -21000  The application has
  310.  
  311. 
  312.  
  313. 
  314.  
  315.                                           no menu bar
  316.  
  317.                   mBarNFnd        -126    The application has
  318.  
  319. Result Codes
  320.  
  321. 
  322.  
  323. 
  324.  
  325. 
  326.  
  327.                   Required or Optional?  Required
  328.  
  329.                   Descriptor Type:  typeNull
  330.  
  331.                                 the event
  332.  
  333.                                 that Menu Events handled
  334.  
  335.                   Description:  A null parameter to verify
  336.  
  337. keyMenuEventsTattoo
  338.  
  339. 
  340.  
  341. 
  342.  
  343. 
  344.  
  345.                   Required or Optional?  Required
  346.  
  347.                   Descriptor Type:  typeShortInteger
  348.  
  349.                                 lower byte
  350.  
  351.                                 character of the item, in the
  352.  
  353.                   Description:  The Command-key equivalent
  354.  
  355.    keyMenuItemCmd
  356.  
  357. 
  358.  
  359. 
  360.  
  361.                   Required or Optional?  Required
  362.  
  363.                   Descriptor Type:  typeShortInteger
  364.  
  365.                                 in the lower byte
  366.  
  367.                   Description:  The style value of the item,
  368.  
  369.    keyMenuItemStyle
  370.  
  371. 
  372.  
  373. 
  374.  
  375.                   Required or Optional?  Required
  376.  
  377.                   Descriptor Type:  typeShortInteger
  378.  
  379.                                 'cicn' resource
  380.  
  381.                                 resource ID of the 'ICON' or
  382.  
  383.                                 which is 256 less than the
  384.  
  385.                   Description:  The icon number of the item,
  386.  
  387.    keyMenuItemIcon
  388.  
  389. 
  390.  
  391. 
  392.  
  393.                   Required or Optional?  Required
  394.  
  395.                   Descriptor Type:  typeShortInteger
  396.  
  397.                                 item, in the lower byte
  398.  
  399.                   Description:  The mark character of the
  400.  
  401.    keyMenuItemMark
  402.  
  403. 
  404.  
  405. 
  406.  
  407.                   Required or Optional?  Required
  408.  
  409.                   Descriptor Type:  typeBoolean
  410.  
  411.                                 enabled
  412.  
  413.                   Description:  Whether or not the item is
  414.  
  415.    keyMenuItemEnabled
  416.  
  417. 
  418.  
  419. 
  420.  
  421.                   Required or Optional?  Required
  422.  
  423.                   Descriptor Type:  typeChar
  424.  
  425.                                 it appears in the menu
  426.  
  427.                   Description:  The text of the item, as
  428.  
  429.    keyMenuItemText
  430.  
  431. 
  432.  
  433. 
  434.  
  435.                   Required or Optional?  Required
  436.  
  437.                   Descriptor Type:  typeShortInteger
  438.  
  439.                                 from 1 at the top of the menu
  440.  
  441.                   Description:  The ID of the item, numbered
  442.  
  443.    keyMenuItemID
  444.  
  445. 
  446.  
  447. 
  448.  
  449. 
  450.  
  451.                   Required or Optional?  Required
  452.  
  453.                   Descriptor Type:  typeAEList
  454.  
  455.                                 following parameters
  456.  
  457.                                 item, each containing the
  458.  
  459.                                 records, one for each
  460.  
  461.                   Description:  A list of Apple event
  462.  
  463. keyDirectObject
  464.  
  465. 
  466.  
  467. 
  468.  
  469. Reply Parameters
  470.  
  471. 
  472.  
  473. 
  474.  
  475.                   Required or Optional?  Required
  476.  
  477.                   Descriptor Type:  typeShortInteger
  478.  
  479.                                 List Apple event
  480.  
  481.                                 returned by a Query Menu
  482.  
  483.                   Description:  The ID of the menu, as
  484.  
  485. keyMenuID
  486.  
  487. 
  488.  
  489. 
  490.  
  491. Parameters
  492.  
  493. 
  494.  
  495. Event ID          kAEMEQueryMenu
  496.  
  497. 
  498.  
  499. Event Class       kMEEventClass
  500.  
  501. 
  502.  
  503. 
  504.  
  505. referenced by the keyMenuItemIcon parameter.
  506.  
  507. complete enough to reconstruct the menu, except for the icon resources
  508.  
  509. containing information about all items in a given menu.  This information is
  510.  
  511. A Query Menu Apple event asks the application to return a list of records
  512.  
  513. 
  514.  
  515. xQuery Menu - list all items in a menu
  516.  
  517. 
  518.  
  519. 
  520.  
  521. 
  522.  
  523. 
  524.  
  525.                                           no menu bar
  526.  
  527.                   mBarNFnd        -126    The application has
  528.  
  529. Result Codes
  530.  
  531. 
  532.  
  533. 
  534.  
  535. 
  536.  
  537.                   Required or Optional?  Required
  538.  
  539.                   Descriptor Type:  typeNull
  540.  
  541.                                 the event
  542.  
  543.                                 that Menu Events handled
  544.  
  545.                   Description:  A null parameter to verify
  546.  
  547. keyMenuEventsTattoo
  548.  
  549. 
  550.  
  551. 
  552.  
  553. 
  554.  
  555.                   Required or Optional?  Required
  556.  
  557.                   Descriptor Type:  typeShortInteger
  558.  
  559.                                 is not a resource
  560.  
  561.                                 that the definition procedure
  562.  
  563.                                 ordinarily 0; -1 signifies
  564.  
  565.                                 procedure ('MDEF') resource,
  566.  
  567.                   Description:  The ID of the menu definition
  568.  
  569.    keyMenuMDEFID
  570.  
  571. 
  572.  
  573. 
  574.  
  575.                   Required or Optional?  Required
  576.  
  577.                   Descriptor Type:  typeBoolean
  578.  
  579.                                 a whole, is enabled
  580.  
  581.                   Description:  Whether or not the menu, as
  582.  
  583.    keyMenuEnabled
  584.  
  585. 
  586.  
  587. 
  588.  
  589.                   Required or Optional?  Required
  590.  
  591.                   Descriptor Type:  typeChar
  592.  
  593.                                 it appears in the menu bar
  594.  
  595.                   Description:  The title of the menu, as
  596.  
  597.    keyMenuTitle
  598.  
  599. 
  600.  
  601. 
  602.  
  603.                   Required or Optional?  Required
  604.  
  605.                   Descriptor Type:  typeShortInteger
  606.  
  607.                                 it may have come from
  608.  
  609.                                 ID of the 'MENU' resource
  610.  
  611.                                 necessarily equal to the
  612.  
  613.                   Description:  The ID of the menu, not
  614.  
  615.    keyMenuID
  616.  
  617. 
  618.  
  619. 
  620.  
  621. 
  622.  
  623.                   Required or Optional?  Required
  624.  
  625.                   Descriptor Type:  typeAEList
  626.  
  627.                                 following parameters
  628.  
  629.                                 menu, each containing the
  630.  
  631.                                 records, one for each
  632.  
  633.                   Description:  A list of Apple event
  634.  
  635. keyDirectObject
  636.  
  637. 
  638.  
  639. 
  640.  
  641. Reply Parameters
  642.  
  643. 
  644.  
  645. Parameters        none
  646.  
  647. 
  648.  
  649. Event ID          kAEMEQueryMenuList
  650.  
  651. 
  652.  
  653. Event Class       kMEEventClass
  654.  
  655. 
  656.  
  657. 
  658.  
  659. Help, Keyboard, or Application menus.
  660.  
  661. in its menu bar.  This information includes the Apple menu, but not the
  662.  
  663. records containing information about all menus defined by the application
  664.  
  665. A Query Menu List Apple event asks the application to return a list of
  666.  
  667. 
  668.  
  669. xQuery Menu List - list all application-defined menus
  670.  
  671. 
  672.  
  673. 
  674.  
  675. 
  676.  
  677. Select Menu Item  Perform a menu command
  678.  
  679. Query Menu        List all items in a menu
  680.  
  681. Query Menu List   List all application-defined menus
  682.  
  683. 
  684.  
  685. 
  686.  
  687. Name              Requested action
  688.  
  689. 
  690.  
  691. xApple events defined in the Menu Events suite
  692.  
  693. 
  694.  
  695. 
  696.  
  697. 
  698.  
  699. parameters.
  700.  
  701. Script,‚Äù which demonstrates the usage of the following events and
  702.  
  703. This package also includes a sample script, ‚ÄúMenu Events Sample
  704.  
  705. information, for the benefit of scripting packages such as AppleScript.
  706.  
  707. contains an 'aete' resource which records the following dictionary
  708.  
  709. definitions which appear here.  The ‚ÄúMenu Events Scripting Addition‚Äù file
  710.  
  711. NOTE:  The C header file ‚ÄúMenu Events.h‚Äù¬†contains the constant
  712.  
  713. 
  714.  
  715. 
  716.  
  717. used in the Apple Event Registry.
  718.  
  719. The following is a formal description of the Menu Events suite, in the form
  720.  
  721. 
  722.  
  723. 
  724.  
  725. √•Menu Events Suite
  726.  
  727. §
  728.  
  729. §
  730.  
  731. 
  732.  
  733. 
  734.  
  735.